Changes the access control information for a directory.

OSErr PBHSetDirAccessAsync (
    HParmBlkPtr paramBlock
);

paramBlock

A pointer to an HFS parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion function.

• ioResult

  On output, the result code of the function.

• ioNamePtr

  On input, a pointer to a pathname.

• ioVRefNum

  On input, a volume specification.

• ioACOwnerID

  On input, the owner ID.

• ioACGroupID

  On input, the group ID.

• ioACAccess

  On input, the directory’s access rights. You cannot set the owner or user rights bits of the ioACAccess field directly (if you try to do this, PBHSetDirAccessAsync returns the result code paramErr).

• ioDirID

  On input, the directory ID.

The PBHSetDirAccessAsync function allows you to change the access rights to the specified directory.

To change the owner or group, you should set the ioACOwnerID or ioACGroupID field to the appropriate ID. You must be the owner of the directory to change the owner or group ID. A guest on a server can manipulate the privileges of any directory owned by the guest.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)